home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / MSDOS / (m)aaj / PD.DOC < prev    next >
Text File  |  1985-04-16  |  12KB  |  330 lines
  1.  
  2.  
  3.  
  4.          PRINT TO DISK Utility,  Operating instructions.
  5.                   Use with version 2.0+ MS DOS
  6.  
  7.  
  8. FUNCTION:
  9.     This utility is designed to redirect the printer output  from 
  10.     an application program to a disk file.
  11.  
  12.     There are three advantages to doing this:
  13.  
  14.         1.  Programs  that  required  a printer may  now  be  run 
  15.             without  physical  having a printer attached  to  the 
  16.             system.
  17.  
  18.         2.  Even if you have a printer, you may just want to look 
  19.             at  a  report without actually needing  a  hard  copy 
  20.             printout.  In this case you can save the paper/ribbon 
  21.             expense  and  general  wear and tear on  the  printer 
  22.             itself.  Later  you  can  print the file  if  you  so 
  23.             desire.
  24.  
  25.         3.  There  are  times  when  only a  portion  of  a  long 
  26.             printout   is  needed,   or  you  may  wish  to   add 
  27.             information or comments,  or incorporate all or  part 
  28.             of a report in another document.
  29.  
  30.             You  may now put the report into a file,  edit it  as 
  31.             desired, and then print the modified file.
  32.  
  33. LIMITATIONS:
  34.     There  are a couple of situations where this utility will not 
  35.     work properly:
  36.  
  37.         1.  This  program  only traps the normal  print  vectors. 
  38.             This covers all normal MS DOS applications  programs, 
  39.             BASIC programs,  and most system type utilities. But, 
  40.             any  program  that works directly with  the  hardware 
  41.             output  port  will continual to function as it  would 
  42.             without this utility.
  43.  
  44.         2.  This program changes the above mentioned vectors.  So 
  45.             do all spoolers, printer drivers, and other utilities 
  46.             that affect printer output or  operation.  Therefore, 
  47.             this   program   MUST  be  the  LAST   utility/driver 
  48.             installed. If it is installed after any other "vector 
  49.             modifying program", it will function as expected.
  50.  
  51.             If not, it will not.
  52.             (see EXAMPLE below).
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                 1
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.         3.  SHIFT/PRINT SCREEN:
  71.             CONTROL/PRINT SCREEN:
  72.             MS DOS redirection (ie: DIR > PRN):
  73.                  These  functions do NOT work with PD.COM if  the 
  74.                  utility is set to DISK,  and they will hang  the 
  75.                  system. If PD.COM is set to PRINTER they do work 
  76.                  normally.
  77.  
  78.  
  79. OPERATION:
  80. Installation:
  81.  
  82.         The  first  time  this  program is run  it  will  install 
  83.         itself.  When  installed,  the resident portion  occupies 
  84.         1.6k of memory.
  85.  
  86.         NOTE- you MUST be in the same DIR:\PATH as PD.COM when it 
  87.               is first run.
  88.  
  89.         Every time PD.COM is run from the terminal after  instal-
  90.         lation,  it will close any open print files,  and then it 
  91.         will ask you if you wish to go to the STATUS/MENU screen. 
  92.         It  is  from this screen that the various options of  the 
  93.         utility may be set.
  94.  
  95.         Once  installed,  the  utility will automatically open  a 
  96.         disk file for output whenever a program attempts to print 
  97.         the first character of a report.
  98.  
  99.         This  file  will stay open,  accepting more  print  data, 
  100.         until:
  101.  
  102.             1.  The  program  itself sends a CTL/Z (end of  file) 
  103.                 character;
  104.             2.  PD.COM is run from the terminal; or
  105.             3.  The  NEXT  program  produces  additional  printer 
  106.                 output.  (Repetitive  reports/printouts from  the 
  107.                 same  program  will all continue to go  into  the 
  108.                 same disk file until that program is exited or it 
  109.                 sends a CTL/Z to the printer.)
  110.  
  111.         When  the file is closed in one of the  above  ways,  the 
  112.         last  memory  buffer  of printer  data  is  automatically 
  113.         written to the file.
  114.  
  115.         NOTE-  MS  DOS will close all files whenever an  applica-
  116.                tion  program exits (stops).If you have just run a 
  117.                program  that produced a printed report  to  disk, 
  118.                then  there  is still part of the printout in  the 
  119.                utilities' printer buffer.  The utility can  sense 
  120.                this  situation and will display a reminder to you 
  121.                on the screen, but it will not automatically write 
  122.                this last buffer.
  123.  
  124.  
  125.  
  126.  
  127.                                 2
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.         There are two ways to close this last file and write this 
  137.         last buffer:
  138.  
  139.             1.  Just run PD.COM from the terminal.  (You need not 
  140.                 go into the STATUS/MENU screen).
  141.             2.  The  next  program that produces  printer  output 
  142.                 will  cause  the last file to be closed  and  the 
  143.                 last buffer written.
  144.  
  145.         Otherwise, if you look at this file (list it or edit it), 
  146.         the very last part of the report will not be visible.
  147.  
  148. FILE NAMES:
  149.     When PD.COM is installed each day, it will begin to open disk 
  150.     files as necessary using the name TMP01.RPT.  As each file is 
  151.     closed  and a new one opened,  '1' is added to the number  in 
  152.     the file name,  and the next name becomes TMP02,  TMP03, etc. 
  153.     up to TMP99.
  154.  
  155.     The utility will check the disk first and not use the name of 
  156.     any  existing file,  in other words,  it will not destroy  an 
  157.     existing file.  When the number in the default file name gets 
  158.     to 99,  the utility will automatically start over again  with 
  159.     01.  If  you  have  enough  disk space and  have  used  every 
  160.     possible  number  from 1 to 99 this program will go  into  an 
  161.     infinite  loop.  Since 99 report files would take up quite  a 
  162.     few megabytes of disk space,  and you,  being  conscientious, 
  163.     will  be  deleting  these files after you are  finished  with 
  164.     them, this situation should never occur (hello Murphy).
  165.  
  166. THE FOLLOWING ARE OPTIONS THAT MAY BE SELECTED FROM THE STATUS/
  167. MENU SCREEN.
  168.  
  169.     (OPTION)  [A]ctive: (Print to DEV):
  170.     This controls the destination of printouts,  DISK or PRINTER. 
  171.     When  the utility is installed, it automatically begins  with 
  172.     output  directed  to the DISK.  This can be changed to  allow 
  173.     output to go to the PRINTER in the normal manner.   From the 
  174.     STATUS/MENU  screen,  type 'A' to toggle from DISK to PRINTER 
  175.     and back.
  176.  
  177.     (OPTION) [M]essages:
  178.     PD.COM will normally print a message whenever it opens a  new 
  179.     output  file.  This  is handy as a reminder of the  name  and 
  180.     DEV/PATH  that  the  new file is  going  into.  But  in  some 
  181.     programs   this   will  interfere  with  what  is   currently 
  182.     displayed.  This  option may be used to suppress these normal 
  183.     messages. Error messages will still be displayed.
  184.  
  185.     (OPTION) [N]ext file name to use:
  186.     You  may  specify a particular device\path\filename  for  the 
  187.     next  disk file name from the STATUS/MENU screen  of  PD.COM. 
  188.     After  this  next printout is completed,  the file name  will 
  189.     then  revert  to the next default file name assigned  by  the 
  190.     utility.
  191.  
  192.  
  193.                                 3
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.     (OPTION) [D]efault device\path:
  203.     The device\path name of the utilities' next default file name 
  204.     can be specified from the STATUS/MENU.
  205.  
  206.          NOTE-  This default device/path does NOT apply to a user 
  207.                 specified file name (above),  it only applies  to 
  208.                 the program's default names.
  209.  
  210.     (OPTION) [Z]ero history fields:
  211.     This  program  keeps  statistics  on its  activity  just  for 
  212.     general information.  The current totals for  day/month/total 
  213.     can  be  reset  to zero when a new owner begins to  use  this 
  214.     program.  The grand totals can not be reset. When the current 
  215.     fields are zeroed, the date installed field is updated.
  216.  
  217. MISCELLANEOUS:
  218.     FREE SPACE:
  219.     The utility will show you the amount of free space  available 
  220.     on  its default device.  Experience with printing reports  to 
  221.     disk will help you determine if there is enough room left for 
  222.     your next report file.
  223.  
  224.     SAVINGS:
  225.     From  the  above  history fields,  estimated savings  can  be 
  226.     computed.  They  are based on the assumptions that a page  of 
  227.     paper  costs  1  1/2 cents,  and ribbons cost  $10.00  per  2 
  228.     million print characters.  There is the additional saving  of 
  229.     wear  and tear on the printer itself (everything wears  out), 
  230.     and  also  the intangible savings of time  and  trouble.  But 
  231.     these, although real, can not be calculated.
  232.  
  233. EXAMPLE of using this utility with a spooler.
  234.  
  235.     MS  DOS's  PRINT  command is probably the  most  widely  used 
  236.     spooler  program available.  This utility and PRINT can  work 
  237.     together.
  238.  
  239.     To  use  both,  remember to install PD.COM  AFTER  installing 
  240.     PRINT.  Do  this by first running PRINT without specifying  a 
  241.     file  name,  PRINT  will ask you for the device name of  your 
  242.     printer.  Answer as you normally would. It will then announce 
  243.     itself as installed.
  244.  
  245.     Then,  being sure you are in the same DEV/PATH as PD.COM, run 
  246.     PD.COM.  PD.COM will then announce itself installed,  and you 
  247.     are in business.
  248.  
  249.     To print 1 or more files with PRINT,  first toggle PD.COM  to 
  250.     PRINTER, and then print the files as you normally would.
  251.  
  252.     NOTE- while  they  are printing,  you can not toggle back  to 
  253.           DISK until they are finished printing.
  254.  
  255.     When they are finished printing,  you may then return to DISK 
  256.     printing.
  257.  
  258.  
  259.                                 4
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.     If you wish to install PD.COM in an AUTOEXEC.BAT file and you 
  269.     plan to use a spooler also, then do it this way:
  270.  
  271.     ...                     ; preceding commands
  272.     ...
  273.     ...
  274.     PRINT                   ;install spooler first
  275.     PD.COM                  ;install PD.COM last
  276.     ...                     ; (be sure your in the same  DEV/PATH 
  277.                               as PD.COM)
  278.     ...
  279.     ...                     ; remainder of AUTOEXEC.BAT
  280.  
  281.     That's  all there is to installing and using PD.COM.  I  hope 
  282.     that this utility will prove as useful  and convenient to you 
  283.     as it has to me.
  284.  
  285.     Remember,  I make my living by writing software for sale.  If 
  286.     you use this program, then I expect you to pay for it. I like 
  287.     the  'FREEWARE'  concept.  I  have been burned by  some  high 
  288.     priced programs that just did not do what I expected (or what 
  289.     they claimed) and then could not return them. It is an advan-
  290.     tage  to  be able to use a program first,  and then  BUY  it. 
  291.     There are a few programs available on this basis,  and  there 
  292.     will be more, if YOU, the user, support this concept.
  293.  
  294.     If not, we all lose.
  295.  
  296.     I  suggest a price of $15.00.  But again,  the worth of  this 
  297.     program  is  the value it is to YOU.  If you agree  with  the 
  298.     concept but not the price, tell me by sending whatever you do 
  299.     think its price should be.
  300.  
  301.     Thank you!
  302.  
  303.             Roy Minier
  304.             490 Burnham Rd.
  305.             Williamsburg, VA  23185
  306.  
  307.  
  308.              --------------------------------------
  309. Downloaded  from the IBMPC special interest area  of  CompuServe, 
  310. uploaded to PCanada by Bob Leigh, PC1022.
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                 5
  326.  
  327.  
  328.  
  329.  
  330.